Miles Sound System SDK 7.2a

DDK Function: 506H Vendor-Specific Extensions

Discussion

Input:

AX = 506H
BX = Driver number
CX = VSE feature identifier (see below)
DX:SI = Pointer to feature-specific input parameter block

Output:

AX = -1 if VSE feature not supported
DX:SI = Pointer to feature-specific output parameter block

By means of this function, MSS applications may take advantage of certain hardware-specific features not otherwise supported by the DDK driver specifications. The Vendor-Specific Extensions (VSE) function provides an open-ended protocol for implementing such hardware-specific functions as interdriver communication, artificial surround sound or 3D sound, special effects, and tone or filter control.

To avoid conflicts and to ensure that MSS users can easily obtain access to new features, RAD will serve as a clearinghouse for vendor-specific extension identifier codes. Any vendor who implements support for a device-dependent feature should submit the following information to RAD:

1) Input parameter block structure

2) Output parameter block structure

3) Detailed description of feature, including input and output parameters and possible side effects

4) Technical support contact name and telephone number for use by application programmers

Upon receipt of the above information, RAD will assign a VSE feature identifier number which may be used to call the VSE feature from MSS.

Currently Reserved VSE Codes

CX: 0 = Roland or other: write string in scratch[] array to front-panel display
CX: 1 = QSound Labs spacial control features

Group: DOS XMIDI Sound Driver Interface